home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / raxs101.zip / RAXS.DOC next >
Text File  |  1993-03-06  |  5KB  |  121 lines
  1.                                     
  2.                                     RAXS
  3.                        R.emote A.ccess X.itinfo S.plitter
  4.                                     v1.01
  5.  
  6.                                By : Mark Lewis
  7.                             
  8.                             For RA 2.00 GAMMA ONLY!
  9.                       (may work with the release version)
  10.                        (if the structure stays the same)
  11.  
  12.  
  13. Purpose:
  14. --------
  15. To split the new EXITINFO.BBS file written by RA 2.00 into two parts. One
  16. part is as close to the RA v1.11 EXITINFO.BBS as possible. The other part is
  17. to hold all the extra data that is in the new format.
  18.  
  19. Limitations:
  20. ------------
  21. This is not a perfect solution! There are limits to what can be done! There
  22. are differences bewteen the old structure and the new structure that =CANNOT=
  23. be adjusted for! One prime example is the following...
  24.  
  25.     LASTREAD Message pointer 
  26.           - used to be a WORD ... 0 - 65535 (16bit)
  27.           - now it is a LONGINTeger ... -2147483646 - 2147483647 (32bit)
  28.  
  29. In looking at the above, it is impossible to put anything bigger than 65535
  30. into the old style LASTREAD pointer in the file. RAXS puts as much as it can
  31. into the file by using typecasting. Anything left over is "thrown away" for
  32. the moment. When RAXS recombines the two parts of the split EXITINFO.BBS 
  33. file, it checks to see if the value it put in the split file is greater than
  34. the typecast part. If it is the same or less, RAXS will place the ORIGINAL
  35. value back into the recombined file. If the value is greater than what was
  36. originally written, RAXS will ADD the DIFFERENCE to the original value and
  37. write that to the recombined file.
  38.  
  39. THIS MEANS THAT RAXS MAY NOT ALLOW EXTERNAL MAIL DOORS TO OPERATE CORRECTLY!
  40.                                     AND
  41. THIS MEANS THAT RAXS MAY NOT ALLOW EXTERNAL FILE DOORS TO OPERATE CORRECTLY!
  42.  
  43. When I say "NOT OPERATE CORRECTLY", I mean that the ratio data, pointer data,
  44. and transfer data MAY not be passed back and forth =accurately=. The doors
  45. will still work but the user's data might not be updated in the BBS
  46. correctly.
  47.  
  48. The following are the fields that are affected...
  49.  
  50.         userinfo.credit    userinfo.pending  userinfo.lastread
  51.         userinfo.nocalls   userinfo.uploads  userinfo.downloads
  52.         userinfo.uploadsk  userinfo.todayk   userinfo.downloadsk
  53.  
  54. In the case of CBV's (callback verifiers), the password fields of the split
  55. EXITINFO.BBS file are set to "PASSWORD" because of the security change made 
  56. in RA. There is not really any other option for this situation. If you use
  57. RAXS to help you run your CBV, you MUST tell the users what the password is
  58. so that they can get back into the system after verification.
  59.  
  60. The MAIN purpose of RAXS is to (hopefully) let you run your "standard" doors
  61. until such time as they can be upgraded to operate correctly with the new
  62. version of RA.
  63.  
  64. Commands:
  65. ---------
  66. RAXS S - will Split the new RA EXITINFO.BBS file into two parts.
  67. RAXS C - will recombine the two parts.
  68.  
  69. Execution:
  70. ----------
  71.  
  72. REM ------------------------
  73. REM - I'm a Door .BAT file -
  74. REM ------------------------
  75. RAXS S               <- Split the EXITINFO.BBS file into two parts
  76. CD\THEDOOR
  77. RUNDOOR              <- run the door
  78. CD\RA
  79. RAXS C               <- Combine the split parts of the EXITINFO.BBS file
  80.  
  81.  
  82. Contact:
  83. --------
  84. I can be contacted via Routed NetMail or in the RA_Support and RAUTIL echos.
  85.  
  86. thanks,
  87.  
  88. )\/(ark Lewis
  89. 1:3634/12
  90.  
  91. Revisions:
  92. ----------
  93.   1.00   -  initial release
  94.   1.01   -  1. decided to check to see what the values were that are
  95.                being returned in the fields that are filled from typecast
  96.                data. if they are greater than the original typecast 
  97.                values, then they are OR'd with the the original values, 
  98.                otherwise the orignial values are used.
  99.  
  100.                ie: downloadsk is 90000.
  101.                    this has a WORD typecast value of 24464.
  102.  
  103.                    when recombining the split parts of the file,
  104.                    the new value is checked. if it is greater than
  105.                    24464 then 90000 has it's lower 16 bits zero'd
  106.                    out and the new value is OR'd back in, thus
  107.                    increasing 90000 by the amount of change -=B-)
  108.  
  109.             2. fixed the problem where the new 15 character phone
  110.                fields would get chopped off at the previous 12
  111.                character limit. this also enabled the ability to update
  112.                a users phone numbers from external programs that used 
  113.                the old limit. if the first 12 characters of the phone 
  114.                number fields are different than what was written during
  115.                the split, the phone number entries WILL be changed to 
  116.                the new entry that is 13 characters long.
  117.             
  118.             3. changed the psuedo password to "PASSWORD" to make it
  119.                easier to use RAXS with CBV doors. MAKE SURE YOU TELL
  120.                THE USERS TO ENTER "PASSWORD" WHEN ASKED FOR ONE!
  121.